home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / flview.zip / README.DOC < prev    next >
Text File  |  1989-01-07  |  20KB  |  609 lines
  1.                             DOSTHINGS  shareware
  2.                     Copyright (c) Windmill Software 1988
  3.    DOSTHINGS is a package of routines that provide an enhancement to those 
  4. found with the standard MS-DOS or PC-DOS routines. They are independent of 
  5. hardware and they are not memory-resident - no interfering with other 
  6. programs. DOSTHINGS is not copy-protected and you are free to make as many 
  7. back-up copies as you like. If you have acquired this package from someone 
  8. else you are asked to send the sum of $25 U.S. or $30 Canadian to:
  9.  
  10.                                Malcolm Drury
  11.                              11 Adele Crescent
  12.                         Nepean, Ontario, K2J 2T7
  13.                                   Canada 
  14.                            Phone: (613) 825-1683
  15.                                                                         
  16.        
  17.    Instructions for using the routines follow. You are using one to read 
  18. this file if you typed VIEW README.DOC. README.DOC can be printed out or 
  19. edited using any word processing package that will accept ASCII files as 
  20. input.
  21.                                    Page 1
  22.                                 INSTALLATION
  23.    DOSTHINGS does not need any special installation. If you have a two-
  24. floppy drive system, you can use a back-up copy in drive B and gain access 
  25. to the routines by typing: b:prog where prog is the name of the DOSTHINGS 
  26. routine. Or you can copy the files onto your boot diskette, if there is room 
  27. (see the DUPE routine instruction below). If you have a hard disk, DOSTHINGS 
  28. routines should be in the root directory, or in their own directory. If you 
  29. choose the latter approach, and copy the programs into a directory called 
  30. UTILS, for example, you should have in your boot-up AUTOEXEC.BAT file a 
  31. statement that says:
  32.  
  33. PATH,C:\;C:\UTILS
  34.  
  35. (If you don't have an autoexec.bat file, consult your DOS manual).
  36.  
  37.    DOSTHINGS routines use the standard DOS drive, path and file name 
  38. approach (again, consult your DOS manual if you are not clear about path and 
  39. file names). Thus, in the following descriptions of routines, the following 
  40. apply:  [d:] means drive; [path] means path; file.ext means file name 
  41. and its extension. Square brackets [] mean an item is optional.
  42.                                    Page 2
  43.                                IMPORTANT NOTE
  44.  
  45.    DOSTHINGS uses a method of specifying directories that is slightly 
  46. different from that used by DOS.  Unless a file name (or a wild-card such as 
  47. *.*) is specified, directory names MUST be terminated with a final \.
  48. e.g. ddir c:\dos\dosthings\  - equivalent to DOS dir c:\dosthings        
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                    Page 3
  64. ASCI
  65.  
  66. Purpose:  converts pseudo-ASCII files (e.g. WORDSTAR in document 
  67.           mode) to ASCII. Produces file with same name as original, but with 
  68.           extension .ASC
  69.  
  70. Notes:    wild-card characters * and ? not allowed.
  71.  
  72. Usage:    asci [d:][path]file.ext
  73.  
  74. Example:  convert file "this.one" in directory "wordproc", sub-directory 
  75.           "wordstar" on drive c     asci c:\wordproc\wordstar\this.one
  76.           (Produces this.asc in same directory/sub-directory).
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.                                    Page 4
  85. CHAT
  86.         
  87.  
  88. Purpose: change attribute of file or files
  89.  
  90. Notes:   accepts "wild-card" characters * and ?
  91.  
  92. Usage:   chat [d:][path]file.ext /x
  93.          where x is one of the following:
  94.       
  95.          u  -  unprotect (i.e. make read-and-write)
  96.          r  -  protect (i.e. make read-only)
  97.          h  -  hide (hidden files are unavailable for 
  98.                      use in some DOS versions)
  99. Examples:
  100.          to make file mine.fil hidden:  chat mine.fil /h
  101.          to protect all files on drive b:  chat b:*.* /r
  102.          to unprotect all .COM files on drive c, directory "one", sub-
  103.          directory "two"   chat c:\one\two\*.com /u
  104.  
  105.                                    Page 5
  106. CLR
  107.       
  108.  
  109. Purpose: clears the screen and sets display colour
  110.  
  111. Notes:   this routine clears the screen no matter how many display
  112.          lines or columns there are (DOS cls routine assumes 80 columns and
  113.          25 lines).  The default colour can be modified (see page 23)
  114.  
  115.  
  116. Usage:   clr
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                    Page 6
  127. CODE
  128.  
  129. Purpose:  encodes or decodes files with user-supplied 6 
  130.           character password
  131.  
  132. Notes:    does not accept wild-card characters * or ? 
  133.           in file name
  134.  
  135. Usage:    code [d:][path]file.ext /x
  136.  
  137.           where x is one of the following:
  138.  
  139.           e  -  encode file
  140.           d  -  decode file
  141.  
  142. Examples:  encode file mine.txt   code mine.txt /e
  143.            decode file this.one on directory "mine" of 
  144.            drive c     code c:\mine\this.one /d
  145.  
  146.  
  147.                                    Page 7
  148. DDIR
  149.  
  150. Purpose:  gives a non-scrolling, double-column directory display. Protected 
  151.           files are flagged with a "+", system files with a "s", and files 
  152.           created today with a bright "*". Date is returned in the European 
  153.           format: routines USDDIR and JPDDIR return the date in the American 
  154.           and Japanese formats. Choose the one you want and rename it 
  155.           DDIR.COM.
  156. Notes:    unlike the DOS DIR command, DDIR requires you to close the 
  157.           path name with a \ if no file name specification is given. Failing 
  158.           to do this will produce a list of all sub-directories on the 
  159.           directory specified. Wild-card characters are allowed.
  160. Usage:    ddir [d:][path]file.ext
  161.  
  162. Examples: directory of current drive and directory    ddir
  163.           list of .COM files on drive a    ddir a:*.com
  164.           list of files of directory "one', drive c
  165.           ddir c:\one\    or  ddir c:\one\*.*
  166.  
  167.  
  168.                                    Page 8 
  169. DECDST
  170.         
  171.  
  172. Purpose:  automatically decrements time by 1 hour. Use it in your        
  173.           AUTOEXEC.BAT file during periods of standard time on machines
  174.           such as the IBM-AT that have a built-in clock/calendar set
  175.           during a period of standard time.
  176.           You will not have to re-set the time manually each time you 
  177.           boot the computer.
  178.  
  179. Usage:    decdst
  180.  
  181. See also: setdst
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                                    Page 9
  190. DUPE
  191. Purpose:  copy files to floppy diskette in drive a or b 
  192. Notes:    unlike DOS COPY command, DUPE checks that there is enough space on 
  193.           the diskette - if not it prompts the user to insert another. 
  194.           Options allow copying and deleting from source directory, copying 
  195.           only those files created since midnight, not overwriting protected 
  196.           files on target drive/directory, and copying "system" files.
  197. Usage:    dupe [d:][path]file.ext d:[path] [/x] [/y] ....
  198.           Switches: d - delete source file after copying
  199.                     t - copy only those files created since midnight
  200.                     s - include system files
  201.                     r - do not overwrite protected files on target
  202.                       (default is overwrite).
  203.           Note that more than one switch can be set.
  204. Examples:   Copy all files from current drive to floppy in drive a with
  205.             directory "first"   dupe *.* a:\first\    (note final \)
  206.             Copy all new .COM files from directory "one", sub-directory 
  207.             "two" on drive c to diskette in drive b and delete from c:
  208.             dupe c:\one\two\*.com b: /t /d
  209.  
  210.                                    Page 10
  211. GETPW
  212.           
  213.  
  214. Purpose:  returns current password setting in PASSWORD.COM
  215.  
  216. Usage:    getpw
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                                    Page 11
  232. MEM   
  233.  
  234. Purpose:  gives normal and extended RAM installed and RAM currently free, 
  235.           and gives total bytes available and bytes free on specified drive.
  236.  
  237. Usage:    mem [drive]
  238.  
  239.  
  240. Notes:    the programme is supplied in two versions - MEM86,COM for 80x86
  241.           based machines and MEM88.COM for 8088-based machines.  Select the
  242.           one you want and rename it MEM.COM.                           
  243.                                                                     
  244.                       
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                                    Page 12
  253. PASSWORD
  254.           
  255.  
  256. Purpose:  provides password protection at boot time - useful for keeping 
  257.           unauthorized users of machines with hard disks. PASSWORD.COM 
  258.           should be placed early in your AUTOEXEC.BAT file. N.B. It is not 
  259.           fool-proof!
  260.  
  261. Notes:    prompts the user to enter a 7 character password (any ASCII 
  262.           character is permissible); beeps if wrong, and does not allow 
  263.           further processing. The password is not displayed on-screen.
  264.           The default password can be modified with SETPW.
  265.  
  266. Usage:    password
  267.  
  268.  
  269. THE DEFAULT PASSWORD IS "letusgo". Note that upper and lower case characters 
  270. are not the same.
  271.  
  272.  
  273.                                    Page 13
  274. PURGE
  275.          
  276.  
  277. Purpose:  deletes ALL files from specified directory, including those
  278.           that are protected or hidden.  Optional switch allows removal
  279.           of directory level if there are no sub-directories in it.
  280.  
  281. Usage:    purge [d:]directory[\subdirectory\] [/d]
  282.  
  283.           - d is the optional switch for removing the directory
  284.  
  285. Note:     USE WITH EXTREME CAUTION!
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.                                    Page 14
  295. QDIR
  296.  
  297. Purpose:  lists all files on drive or directory in 5 columns.
  298.  
  299.  
  300. Notes:    optinal switches allow for various file specifications
  301.  
  302.  
  303. Usage:    qdir [d:][path][file.ext] [/x]
  304.  
  305.           where x is the switch:
  306.  
  307.              r - read-only files
  308.              h - hidden files
  309.              s - sub-directories
  310.              u - only unprotected files
  311.  
  312.  
  313.  
  314.  
  315.                                    Page 15 
  316. SETDST
  317.         
  318.  
  319. Purpose:  automatically increments time by 1 hour. Use it in your        
  320.           AUTOEXEC.BAT file during periods of daylight savings time on
  321.           machines such as the IBM-AT that have a built-in  clock/calendar 
  322.           set during periods of standard time.
  323.           You will not have to re-set the time manually each time you 
  324.           boot the computer.
  325.  
  326. Usage:    setdst
  327.  
  328. See also: decdst
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                                    Page 16
  337. SETPW
  338.  
  339. Purpose:  customizes the PASSWORD.COM routine with user-defined, 6 character 
  340.           password. Any ASCII character can be used.
  341.  
  342. Notes:    PASSWORD.COM must be in unprotected mode.
  343.  
  344. Usage:    setpw
  345.  
  346.  
  347.  
  348. See also getpw
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.                                    Page 17
  358. SKIM
  359.  
  360. Purpose:  allows user to skim through all files on a directory. It displays 
  361.           the first 2000 characters of each file, and gives you the 
  362.           opportunity to delete the file. Non-ASCII files will produce odd 
  363.           displays; WORDSTAR and other pseudo-ASCII files will be displayed 
  364.           correctly.
  365.  
  366. Notes:    wild-card characters * and ? are allowed.
  367.  
  368. Usage:    skim [d:][path]file.ext
  369.  
  370.  
  371. Examples: see all files on drive a:   skim a:*.*
  372.      
  373.           see all .ASC files in directory "wordproc" of drive c
  374.           skim c:\wordproc\*.asc
  375.  
  376.           (EGA 43 line x 80 column compatible - set automatically)
  377.  
  378.                                    Page 18
  379. SPACE
  380.  
  381. Purpose:  returns technical information on selected drive, 
  382.           including minimum storage per file. Did you know that some 
  383.           versions of DOS use 8192 bytes to store a 10 byte file on
  384.            a hard disk?
  385.  
  386. Usage:    space [d:]
  387.  
  388.  
  389. Example:  information on default drive    space
  390.           information on drive b          space b
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                    Page 19
  400. SYST
  401.  
  402. Purpose:  makes files "system" or unprotects system files.
  403.  
  404.  
  405. Notes:    not much use to the casual user. If you do not have a thorough 
  406.           understanding of DOS, DO NOT USE THIS ROUTINE!  The first two 
  407.           files on your boot disk (floppy or hard) are essential files, 
  408.           marked as system so that you cannot tamper with them. Delete them 
  409.           from your hard disk at your peril! The main use for the routine is 
  410.           to allow you to make a copy of these files for inspection via 
  411.           DEBUG. Wild-card characters are not permitted.
  412.  
  413. Usage:    syst [d:][path]file.ext /x
  414.  
  415.           where x is u to unprotect a file, s to make it system.
  416.  
  417.  
  418.  
  419.  
  420.                                    Page 20
  421. VIEW
  422. Purpose:  Displays text files on-screen, page by page.
  423. Notes:    Switches: /ws - Wordstar               /w2 - Wordstar 2000        
  424.                     /p4 - Wordperfect Rel. 4.2   /p5 - Wordperfect Rel. 5.0
  425.                     /a - ASCII (default unless modified by user)
  426. (N.B. See page 29 for notes on modifying view)  
  427. Usage:    view [d:][path]file.ext [switch]         
  428. Example:  view c:\word\myfile.doc /p4       
  429.  
  430. Keys:     F1          - menu for miscellaneous functions
  431.           PgDn        - next page
  432.           PgUp        - previous page
  433.           Home        - first page              
  434.           End         - last page  
  435.           Up arrow    - line up
  436.           Down arrow  - line down
  437.           Esc         - end job
  438.           Right arrow - show rightmost part of display
  439.           Left arrow  - restore normal display
  440.           Del         - delete the file
  441.                                    Page 21 
  442.  
  443.                         NOTES FOR EXPERIENCED USERS
  444.  
  445. PASSWORD is not a fool-proof way of ensuring security - short of buying 
  446. expensive hardware "keys" there is really no way of keeping people off your 
  447. computer.  However, if you include PASSWORD.COM as the first line in your 
  448. AUTOEXEC.BAT file, most people will be prevented from gaining access.  This 
  449. is particularly useful if you have a hard disk containing files you don't 
  450. want to be seen, or fooled around with.  By hitting Ctrl-C early in the boot 
  451. process, you can cause the AUTOEXEC.BAT file to be stopped; if early enough, 
  452. even PASSWORD.COM may be circumvented.  There are other ways of aiding 
  453. security.  If you are familiar with DEBUG, you can change the DIR command to 
  454. something else - say DRY - then make a copy of PASSWORD.COM to DIR.COM.  As 
  455. DIR is probably the first command a tamperer will type he/she will then be 
  456. faced with the "enter password" message.  This only works if the modified 
  457. version of COMMAND.COM is on the boot disk.  If another is used, the 
  458. unmodified version of DEBUG will be used.  You can help prevent this by 
  459. renaming the next most likely command - TREE - to, say, TRRE, and again 
  460. making a copy of PASSWORD.COM to TREE.COM.  This version is independent of 
  461. the boot disk.
  462.                                    Page 22
  463. CHANGING DEFAULT DISPLAY COLOURS
  464.  
  465.    Some routines (see page 24) have a preset display colour.  The colour can
  466. be changed by using the DEBUG routine provided with DOS.  Before attempting
  467. to modify any routine, FIRST MAKE A BACKUP COPY AS INSURANCE.
  468.    To change a default colour, you change a byte at a particular location in 
  469. the routine's code.  The general way of doing this is as follows (using 
  470. clr.com as an example).  You should type the commands shown in BLOCK letters.
  471. Ignore the comments preceded by a semi-colon.
  472.  
  473. ATTS            ;routine to display available colours for your monitor
  474. DEBUG CLR.COM   ;load the debug routine
  475. E XXX ZZ        ;type in the new colour selection ZZ (2 digits, using an
  476.                 ;an initial 0 if required) at address XXX (see next page).
  477.                 ;Use the hexadecimal value given in parentheses in the ATTS
  478.                 ;display.  For example, to set your display to show reverse
  479.                 ;video on a monochrome monitor, (black on white on a colour
  480.                 ;monitor), ZZ will be 70
  481. w               ;make change to clr.com permanent
  482. q               ;leave debug
  483.                                    Page 23
  484.    These are the routines for which the colour of display can be modified,
  485. with the value to be typed in immediately following the E:
  486. clr
  487. E 105 ZZ  ;i.e. XXX is 105
  488.  
  489. ddir
  490. E 22a ZZ  ;set display colour
  491. E 22b ZZ  ;set colour of highlight asterisk
  492.  
  493. mem
  494. E 11F ZZ
  495.  
  496. skim
  497. E 103 ZZ
  498.  
  499. qdir
  500. E 32E YY  ;set display colour
  501. E 32F ZZ  ;set colour of highlight asterisk
  502.  
  503.  
  504.                                    Page 24
  505. NOTES ON USING VIEW.EXE AND ATTS.EXE
  506.  
  507.    These routines are designed to display output quickly. If you have a
  508. colour display card and monitor, you may see "snow" when the display changes.
  509. This problem occurs with older cards such as the original IBM colour graphics
  510. adaptor.  If you experience this problem, and find it bothersome, you can
  511. prevent it by typing:   set mjdsno=on
  512. The speed of display will be considerably reduced, but the "snow" will 
  513. disappear.  To make this a permanent feature, you should add the line
  514.  
  515. set mjdsno=on
  516.  
  517. to your autoexec.bat file; the "snow removal" will then take effect 
  518. immediately when you boot your computer.
  519.  
  520.    To change display colours of  view  see page 29.
  521.  
  522.  
  523.  
  524.  
  525.                                    Page 25
  526. COLOURED MONOCHROME!
  527.  
  528.    If you have an enhanced graphics adaptor with a multisync monitor such as
  529. the NEC Multisync, you may be able to get full colour display with 
  530. monochrome quality text.  To achieve this you must operate your system in 
  531. video mode 7 and also do the following:
  532.  
  533. First, remap the EGA default colour scheme.  The routine egapal will do this 
  534. for you.  Then type  set mjdprg=on   
  535.  
  536.    To make this permanent, you should add the following lines to your
  537. autoexec.bat file:
  538.  
  539. egapal
  540. set mjdprg=on
  541.  
  542.    The default colours in egapal can be modified using debug.  First, run 
  543. the routine  egaset  and make a note of the colours you wish  egapal  to
  544. produce for each of the sixteen possible choices.  Then change the default
  545. colours in egapal with debug.        (Continued on next page)
  546.                                    Page 26
  547.    For each of the numbers 0 - 15 (0 - 0f hex) shown on the left when you
  548. run egapal, you can substitute any colour between 0 and 64.  For example, to
  549. change colour 4 to 48, type    4 48  at the "Enter old and new ... " prompt.
  550. The new colour associated with original colour 4 will be shown in the box.
  551. Whwn you have obtained a colour system you like, MAKE A NOTE OF THE NEW
  552. COLOUR SETTINGS, USING THE HEX VALUES in the rightmost column.  Then change
  553. egapal by the following method (ignoring comments following semicolons):
  554.    First, amke a backup copy of egapal.com
  555.    Then type the following:
  556.  
  557. DEBUG EGAPAL.COM
  558. E 107 AA        ; AA is the hex value for the new colour for colour 0
  559. E 10D BB        ; BB  "  "   "    "    "   "   "    "     "    "    1
  560. E 113 CC        ; CC is for colour 3
  561. E 116 DD        ; DD is for colour 4
  562. E 11F EE        ;etc.
  563. E 125 FF
  564. E 12B GG
  565. E 131 HH
  566. E 137 II           ; continues on next page
  567.                                    Page 27
  568. E 13D JJ
  569. E 143 KK
  570. E 149 LL
  571. E 14F MM
  572. E 155 NN
  573. E 15B OO
  574. E 161 PP        ;last colour
  575. W
  576. Q
  577.  
  578.    You will now need to type  egapal  for the new colour scheme to take 
  579. effect.  Note that changing modes will destroy this remapping; if you do
  580. change modes, you should run egapal again.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.                                    Page 28              
  589. CHANGING DISPLAY COLOURS OF VIEW.EXE
  590.  
  591.    As this routine is in "exe" format it cannot be debugged directly.  Hence 
  592. a routine called MODVIEW is available.  The parameters that can be changed 
  593. are:
  594.      text display
  595.      instructions display
  596.      top/bottom border display
  597.      highlighted text display
  598.      number of lines/page for print-out
  599.      number of spaces by which tabs are expanded
  600.      default file style (ASCII, Wordstar etc.) - used if file called
  601.                                          with no command line switch.
  602. To change VIEW, make sure you have a back-up of the original version, then
  603. ensure that you have a copy of VIEW.EXE and MODVIEW.EXE in the same 
  604. directory or diskette.  VIEW.EXE should not be marked "read-only".  Then, 
  605. simply type  MODVIEW  and answer the questions.
  606.  
  607. N.B. The version of VIEW.EXE supplied has ASCII as the default display.
  608.  
  609.                                    Page 29